home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / Xm / XmTextCut.z / XmTextCut
Encoding:
Text File  |  2001-04-17  |  4.4 KB  |  67 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmTTTTeeeexxxxttttCCCCuuuutttt((((3333XXXX))))             UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV             XXXXmmmmTTTTeeeexxxxttttCCCCuuuutttt((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmTTTTeeeexxxxttttCCCCuuuutttt - A Text function that copies the primary
  10.           selection to the clipboard and deletes the selected text
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           #include <Xm/Text.h>
  14.           BBBBoooooooolllleeeeaaaannnn XXXXmmmmTTTTeeeexxxxttttCCCCuuuutttt(
  15.           WWWWiiiiddddggggeeeetttt wwwwiiiiddddggggeeeetttt,
  16.           TTTTiiiimmmmeeee ttttiiiimmmmeeee);
  17.  
  18.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  19.           This page documents Motif 2.1.
  20.  
  21.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.           XXXXmmmmTTTTeeeexxxxttttCCCCuuuutttt copies the primary selected text to the clipboard
  23.           and then deletes the primary selected text.  This routine
  24.           calls the widget's XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk and verification
  25.           callbacks, either XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk or
  26.           XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkWWWWccccssss, or both. If both verification
  27.           callback lists are registered, the procedures of the
  28.           XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk list are executed first and the
  29.           resulting data is passed to the XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkWWWWccccssss
  30.           callbacks.
  31.  
  32.           This routine calls the XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures,
  33.           possibly multiple times, with the _s_e_l_e_c_t_i_o_n member of the
  34.           XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt set to _C_L_I_P_B_O_A_R_D and with the _p_a_r_m
  35.           member set to XXXXmmmmMMMMOOOOVVVVEEEE.  If the transfer is successful, this
  36.           routine then calls the XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures for the
  37.           _C_L_I_P_B_O_A_R_D selection and the _D_E_L_E_T_E target.
  38.  
  39.           _w_i_d_g_e_t    Specifies the Text widget ID.
  40.  
  41.           _t_i_m_e      Specifies the server time at which the selection
  42.                     value is to be modified. This should be the time
  43.                     of the event that triggered this request.  One
  44.                     source of a valid time stamp is the function
  45.                     XXXXttttLLLLaaaassssttttTTTTiiiimmmmeeeessssttttaaaammmmppppPPPPrrrroooocccceeeesssssssseeeedddd(((()))).
  46.  
  47.           For a complete definition of Text and its associated
  48.           resources, see XXXXmmmmTTTTeeeexxxxtttt(3).
  49.  
  50.      RRRREEEETTTTUUUURRRRNNNN
  51.           This function returns False if the primary selection is
  52.           NULL, if the _w_i_d_g_e_t does not own the primary selection, if
  53.           the function is unable to gain ownership of the clipboard
  54.           selection, or if no data is placed on the clipboard.
  55.           Otherwise, it returns True.
  56.  
  57.      RRRREEEELLLLAAAATTTTEEEEDDDD
  58.           XXXXmmmmTTTTeeeexxxxtttt(3).
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                           (printed 4/6/01)
  64.  
  65.  
  66.  
  67.